JCSM Shareware Collection 1996 September

home *** CD-ROM | disk | FTP | other *** search

/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / czlis110.zip / CZLIST.DOC < prev next >

Wrap

Text File | 1994-10-29 | 62KB | 1,298 lines

CzarList Custom Controls for VBDOS Version 1.10 October 29, 1994 Copyright (c) 1994 by CZAR Software All Rights Reserved. P.O. Box 370087 El Paso, TX 79937-0087 USA Support BBS: (915) 595-8705 Voice: (915) 595-8787 CompuServe: 71031,3614 Fax: (915) 595-8787 Fido: 1:381/99 ┌---------┐ ┌-----┴---┐ │ (R) --│ │o │------------------ │ ┌-----┴╨--┐ │ Association of │ │ │-┘ Shareware └---│ o │ Professionals ------│ ║ │-------------------- └----╨----┘ MEMBER STAR (Shareware Trade Association and Resources) MEMBER All other product names mentioned herein are trademarks of their respective companies. CzarList is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for member products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536. The OMB may be contacted by FAX by sending to the ASP FAX number: (616) 788-2765. In communication with the OMB please include a telephone number and/or FAX if available. ============================================================== Contents Page 1 -------- -------- Introduction What is CzarList. . . . . . . . . . . . . . . . . . . . 2 Features. . . . . . . . . . . . . . . . . . . . . . . . 3 Setup Hardware Requirements . . . . . . . . . . . . . . . . . 4 Software Requirements . . . . . . . . . . . . . . . . . 4 Operating CzarList How to use CzarList . . . . . . . . . . . . . . . . . . 5 CzList (Properties, Events, Methods). . . . . . . . . . 6 Custom Property: Max (Integer) . . . . . . . . . . . 7 Custom Property: Mode (Integer). . . . . . . . . . . 8 Custom Property: Sorted (Boolean). . . . . . . . . . 9 Custom Property: Value (Integer) . . . . . . . . . . 10 Custom Method: CLS (Method). . . . . . . . . . . . . 11 Custom Method: REFRESH (Method). . . . . . . . . . . 12 CzDir (Properties, Events, Methods) . . . . . . . . . . 13 Custom Property: Drive (String). . . . . . . . . . . 14 Custom Property: Max (Integer) . . . . . . . . . . . 15 Custom Property: Mode (Integer). . . . . . . . . . . 16 Custom Property: Sorted (Boolean). . . . . . . . . . 17 Custom Property: Value (Integer) . . . . . . . . . . 18 Custom Method: CLS (Method). . . . . . . . . . . . . 19 Custom Method: REFRESH (Method). . . . . . . . . . . 20 CzFile (Properties, Events, Methods). . . . . . . . . . 21 Custom Property: Max (Integer) . . . . . . . . . . . 22 Custom Property: Mode (Integer). . . . . . . . . . . 23 Custom Property: Path (String) . . . . . . . . . . . 24 Custom Property: Sorted (Boolean). . . . . . . . . . 25 Custom Property: Value (Integer) . . . . . . . . . . 26 Custom Method: CLS (Method). . . . . . . . . . . . . 27 Custom Method: REFRESH (Method). . . . . . . . . . . 28 CzGetWhatKindMem%() . . . . . . . . . . . . . . . . . . 29 CzItemsTagged%(). . . . . . . . . . . . . . . . . . . . 30 CzAllowTagging% (YesNo%). . . . . . . . . . . . . . . . 31 CzKeyBTagScrolling% (YesNo%). . . . . . . . . . . . . . 32 CzMouTagScrolling% (YesNo%) . . . . . . . . . . . . . . 33 CzSetVirtualPath% (PathToSet$). . . . . . . . . . . . . 34 CzSetStartFileNumber% (FileNumber%) . . . . . . . . . . 35 Troubleshooting . . . . . . . . . . . . . . . . . . . . 36 The Future. . . . . . . . . . . . . . . . . . . . . . . 37 Appendix A. What you get when you register . . . . . . . . . . . 38 B. Registration Form . . . . . . . . . . . . . . . . . 39 C. Get the newest releases of CzarList . . . . . . . . 40 D. What is shareware and how does it work . . . . . . . 41 License Agreement. . . . . . . . . . . . . . . . . . . . . 42 Warranty Disclaimer. . . . . . . . . . . . . . . . . . . . 43 Copyright Notice . . . . . . . . . . . . . . . . . . . . . 44 ============================================================== What is CzarList Page 2 ---------------- -------- Welcome to CzarList, the most powerful custom control library for VBDOS. CzarList offers 3 Custom ListBox Controls for VBDOS Programmers. All three controls use XMS, EMS, or disk space to store the data. Easily store up to 32,765 items per listbox without using any string space or conventional memory. Each listbox control fully supports tagging and untagging. Also, all controls support the .CLS method so you can quickly clear the contents in a fraction of a second even if you store up 32,767 items. No need to use .REMOVEITEM anymore. CzarList is NOT freeware nor public domain. CzarList is shareware. CzarList is copyrighted. CZAR Software retains ownership of that copyright. Anyone who continues to use CzarList after a trial period of 30 days is obligated to purchase CzarList by paying a small registration fee. Only with your support, CzarList can be continued to be developed and improved. ============================================================== Features Page 3 -------- -------- The CzarList Control library features: o CzList, a general listbox which you can use to display pretty much any data as long as the data is string data (variable length or fixed length). o CzDir, displays alphabetically sorted directories in graphical tree format. CzDir stores the graphical tree to display as well as the directory paths. o CzFile, displays files with name, size, date, time, and attributes. ============================================================== Hardware Requirements Page 4 --------------------- -------- - 80286 or better - 512K RAM ============================================================== Software Requirements --------------------- - MS-DOS v3.30 or higher - VBDOS v1.00 or higher ============================================================== How to use CzarList Page 5 ------------------- -------- The source code for the DEMO program is fully documented and shows how to use the controls. The demo program shows many examples on how each control could be used. To run the demo from the DOS prompt, use DEMO.EXE. To run the demo in the VBDOS programming environment, type the following from the DOS prompt: VBDOS DEMO.MAK /L CZLIST Everything runs without any restrictions. You can use the Quick Library CZLIST.QLB to test and run your programs. When you register CzarList, you will receive the CZLIST.LIB file so that you can create your own EXE files. Use file REGISTER.DOC or CREDIT.DOC to register. Make sure the following files are included in this package: CATALOG DOC - The CZAR Software product catalog CREDIT DOC - How to order with your credit card CZLIST DOC - This file CZLIST QLB - Quick Library for VBDOS DEMO EXE - An example program of CzarList DEMO FRM - Demo form file (ASCII Format) DEMO MAK - Demo make file DEMO BAS - Demo source module file DEMOALL FRM - Demo form file (ASCII Format) that shows CzDir and CzFile DEMODIR FRM - Demo form file (ASCII Format) that shows CzDir DEMOFILE FRM - Demo form file (ASCII Format) that shows CzFile FILE_ID DIZ - BBS description file, a short desciption of CzarList GENERAL FRM - A general form file (ASCII Format) ORDER FRM - How to order CzarList (ASCII Format) PACKING LST - A list of all files included in this package README DOC - This file REGISTER DOC - The registration file for CzarList VENDOR DOC - Disk vendors should read this WHATSNEW DOC - List the newest improvments {SDA ID} - A description file for the SDN network distribution Total = 20 Files ============================================================== CzList (Properties, Events, Methods) Page 6 ------------------------------------ -------- CzList is a general listbox control. You can use it to display and list any kind of information. Each element in the listbox can be up to 76 characters long. It fully supports tagging and untagging. CzList will first try to use XMS memory. If no XMS memory is available, it will try to use EMS memory. If no XMS and no EMS memory is available, CzList will use the disk as virtual memory. The amount of conventional memory used will not change even if you put 32,765 (the maximum) elements into CzList. You must UNLOAD the form or control(s) before you end your program. CzList will then remove itself from memory. If you do not UNLOAD the form or control, the memory used by CzList (either CMS, EMS, or disk space) will not be released and unpredictable results can occur. IMPORTANT: Do not set an index with the ADDITEM method when adding items into the listbox for the first time. For example, do NOT use the following method: FOR i = 1 TO 100 CzList.ADDITEM "Some string", i NEXT The correct usage is: FOR i = 1 TO 100 CzList.ADDITEM "Some string" NEXT Usually, you fill your listbox in the FORM_LOAD procedure. After you have filled CzList with your items, you can use ADDITEM with an index number throughout your program. If you do not fill your listboxes in the FORM_LOAD procedure for the first time, you should use a flag to first initialize the position in the listbox. For example: SUB AddAnItem (ItemToAdd$, Position%) STATIC FillFlag% ' Keep value IF NOT FillFlag% THEN CzList.ADDITEM ItemToAdd$ FillFlag% = -1 ' True ELSE CzList.ADDITEM ItemToAdd$, Position% END IF END SUB Properties: BackColor BorderStyle CtlName DragMode Enabled ForeColor Height Index LargeChange Left List() ListCount ListIndex *Max *Mode MousePointer Row *Sorted TabIndex TabStop Tag Text Top *Value Visible Width Events: Change Click DblClick DragDrop DragOver DropDown GotFocus KeyDown KeyPress KeyUp LostFocus MouseDown MouseMove MouseUp Resize Timer Methods: ADDITEM *CLS DRAG HIDE MOVE PRINT *REFRESH REMOVEITEM SETFOCUS SHOW Note: Custom Properties, Events, and Methods have an asterisk "*" next to the names. ============================================================== CzList (Properties, Events, Methods) Page 7 ------------------------------------ -------- ****************************** Custom Property: Max (Integer) ****************************** Description: The Max property initializes CzList and prepares the control to be used in your forms. The Max property can be set or returned. It tells CzList the maximum number of elements ever to be used. This simply means that during runtime you will never use more than Max of elements in the listbox. You can only set the Max property once. You should do this when your program first starts up or set the Max property in the Form Designer. Once the Max property has been set, it MUST not be changed during runtime. The maximum value is 32765. Usage: [FORM.]CzList.Max = Integer% Remarks: It is absolute necessary that you use the Max property. If you do not set the Max property, you will get error #52 (Bad File Name or Number). ============================================================== CzList (Properties, Events, Methods) Page 8 ------------------------------------ -------- ******************************* Custom Property: Mode (Integer) ******************************* Description: The Mode property forces CzList to use certain kinds of storage methods. The Mode property can be set or returned. Use it only if you really need it. By default, CzList will first try to use XMS memory. If no XMS memory is available, CzList will try to use EMS memory instead. If no EMS memory is available, CzList will then use the disk as virtual memory. If you force CzList to use XMS Memory, CzList will still try to use EMS memory if no XMS memory is available. If no EMS memory is available, CzList will use the disk. If you force CzList to use EMS memory, do NOT run your program in the VBDOS environment as it will not work correctly. You have to compile your program into an EXE file. In order for CzarList to use any Extended memory (XMS), you need to load an extended memory driver such as HIMEM.SYS. In order for CzarList to use any Expanded memory (EMS), you need to load an expanded memory driver such as EMM386 (for 80386 computers) etc. Usage: [FORM.]CzList.Mode = Integer% Remarks: The MODE property has to be set before you call any other CzList commands and before you load the form or control. Set the Mode property before the Max property. Integer% Description -------------------------------------------------------------- -1 Use XMS Memory -2 Use EMS Memory -3 Use the disk as virtual memory ============================================================== CzList (Properties, Events, Methods) Page 9 ------------------------------------ -------- ********************************* Custom Property: Sorted (Boolean) ********************************* Description: Sets or returns the sorted status of the control. CzList will only sort the list everytime you set the Sorted property. It will not sort the list when you use the ADDITEM method. The more elements you have stored in CzList, the longer it will take to sort CzList. This can take a very long time if you have up to 32,765 elements. The internal sorting method is a Shellsort. The Shellsort is by far the fastet sorting method compared to other sorting algorithms such as bubble sort, exchange sort, quick sort, etc. The sorting routine in CzList is written in optimized VBDOS source code because there are no sorting algorithms for XMS or EMS data that can be used with VBDOS custom controls. Usage: [FORM.]CzList.Sorted = Boolean% Remarks: Set the Sorted property to true if you want the list to be sorted. Boolean% Description -------------------------------------------------------------- TRUE(-1) The list will be sorted FALSE(0) The list will not be sorted ============================================================== CzList (Properties, Events, Methods) Page 10 ------------------------------------ -------- ******************************** Custom Property: Value (Integer) ******************************** Description: The Value property sets or returns the tagging action. Setting the Value property causes all items in the list to be tagged or untagged. Usage: [FORM.]CzList.Value = Integer% Remarks: Use the CzAllowTagging% function to allow tagging by the user or not. Integer% Description -------------------------------------------------------------- 1 Tag all elements 2 Untag all elements ============================================================== CzList (Properties, Events, Methods) Page 11 ------------------------------------ -------- *************************** Custom Method: CLS (Method) *************************** Description: Invoking the CLS method causes the control to clear all items stored. It will also clear the display from any items currently listed. Usage: [FORM.]CzList.CLS Remarks: Not available at design time. The .CLS method is the fastest way to clear the control in a fraction of a second. This eliminates using the slow .REMOVEITEM method. ============================================================== CzList (Properties, Events, Methods) Page 12 ------------------------------------ -------- ******************************* Custom Method: REFRESH (Method) ******************************* Description: Invoking the REFRESH method causes the control to update the screen display. You must use the REFRESH method after you are finished using the ADDITEM method. This has been done to improve the performance. If you do not use the REFRESH method, the user will see an empty listbox until a CLICK event has occured. Usage: [FORM.]CzList.REFRESH Remarks: Not available at design time. ============================================================== CzDir (Properties, Events, Methods) Page 13 ----------------------------------- -------- CzDir is a directory listbox control. It displays an alphabetically sorted, graphical directory tree. It fully supports tagging and untagging. CzDir will first try to use XMS memory. If no XMS memory is available, it will try to use EMS memory. If no XMS and no EMS memory is available, CzDir will use the disk as virtual memory. The amount of conventional memory used will not change even if all 32,765 (the maximum) elements are used. You must UNLOAD the form or control(s) before you end your program. CzDir will then remove itself from memory. If you do not UNLOAD the form or control, the memory used by CzDir (either CMS, EMS, or disk space) will not be released and unpredictable results can occur. Properties: BackColor BorderStyle CtlName DragMode *Drive Enabled ForeColor Height Index LargeChange Left List() ListCount ListIndex *Max *Mode MousePointer Row *Sorted TabIndex TabStop Tag Text Top *Value Visible Width Events: Change Click DblClick DragDrop DragOver DropDown GotFocus KeyDown KeyPress KeyUp LostFocus MouseDown MouseMove MouseUp Resize Timer Methods: ADDITEM *CLS DRAG HIDE MOVE PRINT *REFRESH REMOVEITEM SETFOCUS SHOW Note: Custom Properties, Events, and Methods have an asterisk "*" next to the names. ============================================================== CzDir (Properties, Events, Methods) Page 14 ----------------------------------- -------- ******************************* Custom Property: Drive (String) ******************************* Description: Sets or returns the current drive to read. CzDir reads the entire drive including all directory paths. It will then display a graphical tree structure. The tree structure is alphabetically sorted, including subdirectories. CzDir reads all directories including hidden ones. Usage: [FORM.]CzDir.Drive = String$ Remarks: Example: CzDir.Drive = "C:" would read drive C: into CzDir. Reading the List() property would return the full path of a list element. See the DEMO for examples. ============================================================== CzDir (Properties, Events, Methods) Page 15 ----------------------------------- -------- ****************************** Custom Property: Max (Integer) ****************************** Description: See CzList Usage: [FORM.]CzDir.Max = Integer% Remarks: See CzList ============================================================== CzDir (Properties, Events, Methods) Page 16 ----------------------------------- -------- ******************************* Custom Property: Mode (Integer) ******************************* Description: See CzList Usage: [FORM.]CzDir.Mode = Integer% Remarks: See CzList ============================================================== CzDir (Properties, Events, Methods) Page 17 ----------------------------------- -------- ********************************* Custom Property: Sorted (Boolean) ********************************* Description: See CzList Usage: [FORM.]CzDir.Sorted = Boolean% Remarks: See CzList ============================================================== CzDir (Properties, Events, Methods) Page 18 ----------------------------------- -------- ******************************** Custom Property: Value (Integer) ******************************** Description: See CzList Usage: [FORM.]CzDir.Value = Integer% Remarks: See CzList ============================================================== CzDir (Properties, Events, Methods) Page 19 ----------------------------------- -------- *************************** Custom Method: CLS (Method) *************************** Description: See CzList Usage: [FORM.]CzDir.CLS Remarks: See CzList ============================================================== CzDir (Properties, Events, Methods) Page 20 ----------------------------------- -------- ******************************* Custom Method: REFRESH (Method) ******************************* Description: See CzList Usage: [FORM.]CzDir.REFRESH Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 21 ------------------------------------ -------- CzFile is a file listbox control. It displays file name, file size, file date, file time, and file attributes. It fully supports tagging and untagging. CzFile will first try to use XMS memory. If no XMS memory is available, it will try to use EMS memory. If no XMS and no EMS memory is available, CzDir will use the disk as virtual memory. The amount of conventional memory used will not change even if all 32,765 (the maximum) elements are used. You must UNLOAD the form or control(s) before you end your program. CzFile will then remove itself from memory. If you do not UNLOAD the form or control, the memory used by CzFile (either CMS, EMS, or disk space) will not be released and unpredictable results can occur. Properties: Action Alignment Archive AutoRedraw BackColor BorderStyle Caption Checked Column ControlID CtlName CurrentX CurrentY Drive DragMode Enabled Filename ForeColor Height Hidden Index Interval LargeChange Left List() ListCount ListIndex *Max Min *Mode MousePointer MultiLine Normal *Path Pattern ReadOnly Row ScaleHeight ScaleWidth ScrollBars SelLength SelStart SelText SmallChange *Sorted Style System TabIndex TabStop Tag Text Top TypeID *Value Visible Width Events: Change Click Custom DblClick DragDrop DragOver DropDown GotFocus KeyDown KeyPress KeyUp LostFocus MouseDown MouseMove MouseUp Paint PathChange PatternChange Resize Timer Methods: ADDITEM *CLS DRAG HIDE MOVE PRINT REFRESH REMOVEITEM SETFOCUS SHOW Note: Custom Properties, Events, and Methods have an asterisk "*" next to the names. ============================================================== CzFile (Properties, Events, Methods) Page 22 ------------------------------------ -------- ****************************** Custom Property: Max (Integer) ****************************** Description: See CzList Usage: [FORM.]CzFile.Max = Integer% Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 23 ------------------------------------ -------- ******************************* Custom Property: Mode (Integer) ******************************* Description: See CzList Usage: [FORM.]CzFile.Mode = Integer% Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 24 ------------------------------------ -------- ****************************** Custom Property: Path (String) ****************************** Description: Sets or returns the current path to read. CzFile reads all files in the specified path, including hidden and system files. CzFile reads and displays filename, filesize, filedate, filetime, and fileattributes in one operation. Wildcards are fully supported and MUST be included when setting the Path property. Usage: [FORM.]CzDir.Path = String$ Remarks: Example: CzDir.Path = "C:\CZLIST\*.*" would read all files in C:\CZLIST. Reading the List() property would return the full path and filename of a list element. See the DEMO for examples. ============================================================== CzFile (Properties, Events, Methods) Page 25 ------------------------------------ -------- ********************************* Custom Property: Sorted (Boolean) ********************************* Description: See CzList Usage: [FORM.]CzFile.Sorted = Boolean% Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 26 ------------------------------------ -------- ******************************** Custom Property: Value (Integer) ******************************** Description: See CzList Usage: [FORM.]CzFile.Value = Integer% Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 27 ------------------------------------ -------- *************************** Custom Method: CLS (Method) *************************** Description: See CzList Usage: [FORM.]CzFile.CLS Remarks: See CzList ============================================================== CzFile (Properties, Events, Methods) Page 28 ------------------------------------ -------- ******************************* Custom Method: REFRESH (Method) ******************************* Description: See CzList Usage: [FORM.]CzFile.REFRESH Remarks: See CzList ============================================================== CzGetWhatKindMem%() Page 29 ------------------- -------- Description: The CzGetWhatKindMem% function returns what kind of memory has been used to store the data in CzList, CzDir, or CzFile. Declaration: DECLARE FUNCTION CzGetWhatKindMem% () Usage: Result% = CzGetWhatKindMem% Example: CzList.SETFOCUS SELECT CASE CzGetWhatKindMem% CASE -1 d$ = "XMS Memory" CASE -2 d$ = "EMS Memory" CASE ELSE d$ = "Disk" END SELECT MSGBOX (d$) Result% Description -------------------------------------------------------------- -1 Uses XMS memory -2 Uses EMS memory -3 Uses Disk as virtual memory Remark: None. ============================================================== CzItemsTagged%() Page 30 ---------------- -------- Description: The CzItemsTagged% function returns the number if items tagged in CzList, CzDir, or CzFile. Declaration: DECLARE FUNCTION CzItemsTagged% () Usage: NumberOfItems% = CzItemsTagged% Example: CzList.SETFOCUS MSGBOX ("Items tagged: " + STR$(CzItemsTagged%)) Remark: None. ============================================================== CzAllowTagging% (YesNo%) Page 31 ------------------------ -------- Description: You can use the CzAllowTagging% function to force CzList, CzDir, or CzFile to allow tagging or not. Declaration: DECLARE FUNCTION CzAllowTagging% (YesNo%) Usage: Result% = CzAllowTagging%(YesNo%) Example: CzList.SETFOCUS YesNo% = 0 Result% = CzAllowTagging%(YesNo%) YesNo% Description -------------------------------------------------------------- 0 Allow tagging 1 Allow no tagging Remark: None. ============================================================== CzKeyBTagScrolling% (YesNo%) Page 32 ---------------------------- -------- Description: You can use the CzKeyBTagScrolling% function to force CzList, CzDir, or CzFile to allow scrolling to the next item in the list when tagging with the SPACE BAR. Declaration: DECLARE FUNCTION CzKeyBTagScrolling% (YesNo%) Usage: Result% = CzKeyBTagScrolling%(YesNo%) Example: CzList.SETFOCUS YesNo% = 0 Result% = CzKeyBTagScrolling%(YesNo%) YesNo% Description -------------------------------------------------------------- 0 Scroll to next item 1 Scroll not to next item Remark: CzAllowTagging% must be set to yes (0) for CzKeyBTagScrolling% to work. ============================================================== CzMouTagScrolling% (YesNo%) Page 33 --------------------------- -------- Description: You can use the CzMouTagScrolling% function to force CzList, CzDir, or CzFile to allow scrolling to the next item in the list when tagging with the right mouse button. Declaration: DECLARE FUNCTION CzMouTagScrolling% (YesNo%) Usage: Result% = CzMouTagScrolling%(YesNo%) Example: CzList.SETFOCUS YesNo% = 0 Result% = CzMouTagScrolling%(YesNo%) YesNo% Description -------------------------------------------------------------- 0 Scroll to next item 1 Scroll not to next item Remark: CzAllowTagging% must be set to yes (0) for CzMouTagScrolling% to work. ============================================================== CzSetVirtualPath% (PathToSet$) Page 34 ------------------------------ -------- Description: If CzList, CzDir, or CzFile uses the disk as virtual memory, you will see a slowdown in performance the more elements you use. For this reason, you can tell the control where to store the temporary disk file(s) by setting CzSetVirtualPath$ to the path you want to use. It is recommended to use a RAMDRIVE for this purpose. If you do not specify a path for CzSetVirtualPath$, CzList will use the current path. Note: You MUST set CzSetVirtualPath$ before you set the Max Property. The best way to do this is to set CzSetVirtualPath$ as the first command in your FORM_LOAD procedure. Declaration: DECLARE FUNCTION CzSetVirtualPath% (PathToSet$) Usage: Result% = CzSetVirtualPath%(PathToSet$) Example: CzList.SETFOCUS PathToSet$ = "I:\TEMP" Result% = CzSetVirtualPath%(PathToSet$) Remark: Make sure the drive has enough space left to save the disk file(s). You can calculate the amount of bytes needed using the following formular: DiskSpace& = (CzList.Max + 1) * 76 For example, if you want to use 2000 elements and CzList, CzDir, or CzFile needs to use the disk, you would have to make sure that there are at least (1999 + 1) * 76 = 152,000 Bytes available. ============================================================== CzSetStartFileNumber% (FileNumber%) Page 35 ----------------------------------- -------- Description: If you force CzList, CzDir, or CzFile to use virtual memory with CzarList.Mode = -3, CzList, CzDir, or CzFile will now use filenumbers starting with #10. This should prevent error #55 (File Already Open). If you need more than 9 files open for your own programs, you can tell CzList, CzDir, or CzFile with the CzSetStartFileNumber% function what starting filenumber to use. Declaration: DECLARE SUB CzSetStartFileNumber% (FileNumber%) Usage: CALL CzSetStartFileNumber%(FileNumber%) Example: CzList.SETFOCUS CALL CzSetStartFileNumber(15) Remark: None. ============================================================== Troubleshooting Page 36 --------------- -------- Problem 1: CzarList does not use any extended or expanded *********** memory; eventhough, there is plenty available. Cause: You did not load an extended or expanded memory driver. Solution 1: In order for CzarList to use any Extended memory (XMS), you need to load an extended memory driver such as HIMEM.SYS. In order for CzarList to use any Expanded memory (EMS), you need to load an expanded memory driver such as EMM386 (for 80386 computers) etc. Problem 2: Error #52, "Bad File Name or Number" comes *********** up as soon as I start my program. Cause: You did not initialize by setting the Max property. Solution 1: Please read the section for setting the Max property. Problem 3: Problems getting the GotFocus event when using *********** the access key to try to move to a custom control such as CzList, CzFile, or CzDir. Cause: This is a confirmed bug in Microsoft VBDOS v1.00. Solution 1: None. Please complain as much as you can directly at Microsoft so they can get off their butts and fix the dozens or so other bugs in VBDOS as well. While you're at it, order Microsoft to develop a Windows '95 without the graphical interface = DOS v7.0 (a 32-bit MS-DOS). They would never do it, since it would allow DOS to live on and on. If you encounter any other errors or strange behaviors of CzarList, please call 915-595-8787 or call the support BBS at 915-595-8705. Only if you report the errors, CzarList can be corrected and improved. While you are reporting errors, any suggestions are welcome! ============================================================== The Future Page 37 ---------- -------- There are currently three CzarList controls: CzList, CzDir, and CzFile. CzarList can easily be expanded to include other useful controls such as a message box with more than 3 buttons, a text box control that can hold up to 16 MB of text (the VBDOS textbox control is limited to 32 KB of string space), invisible listbox controls to store up to 2,4 GigaBytes (GB) of integer, long integer, double, or currency numbers (not just up to 32,765 items) perfect for number crunching and financial programs, an input control to force input and output format, etc. Of course, all controls would be able to use XMS, EMS, or virtual memory. The development of these new controls depend on how many people would request them and enough people registering CzarList. If you have new ideas for new controls, please contact CZAR Software. ============================================================== Appendix A. What you get when you register Page 38 ------------------------------------------ -------- o The CZLIST.LIB object library to build your own EXE files o A professionally printed and bound manual o Most current Version of CZLIST.LIB o Discounts on other CZAR Software products (see CATALOG.DOC) o FREE, update notices and bug reports o FREE, lifetime voice Support at 915-595-8787 o FREE, lifetime fax Support o FREE, lifetime BBS Support at 915-595-8705 o FREE, lifetime CompuServe Support at 71031,3614 o FREE, lifetime AOL Support at czarsoft o FREE, lifetime InterNet Support at czarsoft@aol.com You are more than welcome to upload your finished programs to the CZAR Software support BBS at 915-595-8705. The best once will be made available for worldwide download (if you have a shareware or demo version). ============================================================== Appendix B. CzarList Registration Form Page 39 -------------------------------------- -------- CZAR Software Registration Form (Please write in print) Name:_______________________________________________________ Company:____________________________________________________ Address:____________________________________________________ City, State, Zip:___________________________________________ Country:____________________________________________________ Home Phone:__________________ Work Phone:___________________ ------------------------------------------------------------ Q | Product | CIS | Cr. | DM | US$ | Price --|---------------------|------|-----|-------|-------|------ | ACZAR f. DOS | 420 | yes | 59,00 | 35.00 | | ACZAR f. Windows | 2107 | yes | 59,00 | 35.00 | | ACZAR f. DOS German | 420 | yes | 59,00 | 35.00 | | TUCC | no | no | 35,00 | 25.00 | | CZLIST | 2907 | yes |129,00 | 69.00 | ------------------------------------------------------------ Plus shipping/handling (US$ 5.00 for each product)...: (If you pay in German DM or live in Germany, please read the file CATALOG.DOC.) ------------------------------------------------------------ Total amount is in [ ] US$ or in [ ] DM..............: ============================================================ Q = Quantity CIS = CompuServe Registration Number (GO SWREG) Cr. = Can be paid with Credit Card. Please read CREDIT.DOC for more information on how to pay with Credit Card. DM = Price of the product in German Mark (Deutsche Mark) US$ = Price of the product in USA Dollars Price = Subtotal (Q * DM or US$) All products are shipped on 3.5" floppy disks. Please send registration to: CZAR Software P.O. Box 370087 El Paso, TX 79937-0087 USA Comment:____________________________________________________ ____________________________________________________________ ____________________________________________________________ ============================================================== Appendix C. Get the newest releases of CzarList Page 40 ----------------------------------------------- -------- The newest releases of CzarList are available at no cost 24 hours a day on the support BBS in El Paso, TX (915) 595-8705. In addition, you can download CzarList on these fine BBS: USA: 1. Computer Connection . . . . . . . . . . . . 1-201-886-8041 2. Download America . . . . . . . . . . . . . 1-203-673-2502 3. Lightning Board . . . . . . . . . . . . . . 1-205-745-4515 4. Letters . . . . . . . . . . . . . . . . . . 1-206-524-4811 5. Northern Lights . . . . . . . . . . . . . . 1-207-761-4782 6. RunWay 2400 . . . . . . . . . . . . . . . . 1-215-623-6203 RunWay HST . . . . . . . . . . . . . . . . 1-215-623-6103 RunWay v.32 . . . . . . . . . . . . . . . . 1-215-622-7563 7. Amcom . . . . . . . . . . . . . . . . . . . 1-216-526-9480 8. Back Door . . . . . . . . . . . . . . . . . 1-217-762-2847 9. Programmers Corner . . . . . . . . . . . . 1-301-596-1180 10. Paradox . . . . . . . . . . . . . . . . . . 1-302-645-7264 11. Wyoming . . . . . . . . . . . . . . . . . . 1-307-856-3601 12. The Panhandle Connection. . . . . . . . . . 1-308-487-5505 13. Software Creations 2400 . . . . . . . . . . 1-508-365-2359 Software Creations 9600 . . . . . . . . . . 1-508-368-4131 Software Creations 14,400 . . . . . . . . . 1-508-368-4137 14. Channel I . . . . . . . . . . . . . . . . . 1-617-354-3137 15. A Quiet Place In The Woods 9600 . . . . . . 1-706-769-9977 16. CZAR (Home of CZAR Software). . . . . . . . 1-915-595-8705 GERMANY: 18. K.-L. Jaeger. . . . . . . . . . . . . . . . +49-7665-99153 ============================================================== Appendix D. What is shareware and how does it work Page 41 -------------------------------------------------- -------- Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. ============================================================== License Agreement Page 42 ----------------- -------- You may freely distribute your executable programs in the compiled .EXE file format. You are NOT required to display CZAR Software copyright notices or pay royalties. ============================================================== Warranty Disclaimer Page 43 ------------------- -------- Users of CzarList must accept this disclaimer of warranty: "CzarList is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of CzarList." This CzarList (without the CZLIST.LIB Object library file) is a "shareware program" and is provided at no charge to the user for evaluation. The shareware version of CzarList does not contain CZLIST.LIB. CZLIST.LIB is part of the registered version. Feel free to share the shareware version of CzarList with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using CzarList and continue to use CzarList after a reasonable trial period, you must make a registration payment of $69.00 to CZAR Software. The $69.00 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, as long as there is no possibility of it being used at one location while it is being used at another, just as a book cannot be read at the same time by two different persons at two locations. Commercial users of CzarList must register and pay for their copies of CzarList within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting CZAR Software. Anyone distributing CzarList for any kind of remuneration must first contact CZAR Software at the address below for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering CzarList immediately (However, CZAR Software must still be advised so that the distributor can be kept up-to-date with the latest version of CzarList). You are encouraged to pass a copy of CzarList along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the CzarList system. CZAR SOFTWARE DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER CZAR SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE EVEN IF CZAR SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT SHALL CZAR SOFTWARE'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. This agreement shall be governed by the laws of the State of Texas and shall inure to the benefit of CZAR Software and any successors, administrators, heirs and assigns. Any action or proceeding brought by either party against the other arising out of or related to this agreement shall be brought only in a STATE or FEDERAL COURT of competent jurisdiction located in El Paso County, Texas. The parties hereby consent to in personal jurisdiction of said courts. ============================================================== Copyright Notice Page 44 ---------------- -------- Copyright Notice THIS SOFTWARE AND THE DISKS OR ANY OTHER MEDIA ON WHICH IT IS CONTAINED IS LICENSED TO YOU, FOR YOUR OWN USE. THIS IS COPYRIGHTED SOFTWARE. YOU ARE NOT OBTAINING TITLE TO THE SOFTWARE OR ANY COPYRIGHT RIGHTS. YOU MAY NOT SUBLICENSE, RENT, LEASE, CONVEY, MODIFY, TRANSLATE, CONVERT TO ANOTHER PROGRAMMING LANGUAGE, DECOMPILE, OR DISASSEMBLE THE SOFTWARE FOR ANY PURPOSE. YOU MAY MAKE AS MANY COPIES OF THIS SOFTWARE AS YOU NEED FOR BACK-UP PURPOSES ONLY. YOU MAY USE THIS SOFTWARE ON MORE THAN ONE COMPUTER, PROVIDED THERE IS NO CHANCE IT WILL BE USED SIMULTANEOUSLY ON MORE THAN ONE COMPUTER. IF YOU NEED TO USE THE SOFTWARE ON MORE THAN ONE COMPUTER SIMULTANEOUSLY, PLEASE CONTACT CZAR SOFTWARE FOR INFORMATION ABOUT SITE LICENSES.